home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / bbs / pad311.zip / PADLOCK.DOC < prev    next >
Text File  |  1996-09-02  |  20KB  |  470 lines
  1.  
  2.  
  3.                            P   A   D   L   O   C   K
  4.                -------------------------------------------------
  5.                                  version 3.10
  6.                             (C) 1996 Stefan Xenos
  7.  
  8.  
  9.                              L e g a l   S t u f f
  10.                              _____________________
  11.  
  12.         This software is entirely without warrantly, expressed or implied. 
  13. If you decide to use it, you do so at your own risk. The only thing I
  14. guarantee about it is that it will take up space on your hard disk. I take
  15. no responsibility for anything that happens through your use of this
  16. software, no matter how bad it is.
  17.  
  18.         If people weren't in the habit of suing everyone who looked at them
  19. the wrong way, then time and space-wasting messages like this would be
  20. unnecessary.
  21.  
  22.         You may modify this source code however you like for your own
  23. personal use as long as the copyright message and the author's name is not 
  24. removed. You MAY NOT distribute modified versions of the code. You may not 
  25. charge money for the use or distribution of this program without my prior
  26. permission in writing. Feel free to distribute it like crazy as long as you 
  27. don't charge for it.
  28.  
  29.   You may:
  30.  
  31.         - Use Padlock on any sort of electronic bulletin board system,
  32.           even those that charge money for access or provide some
  33.           commercial service.
  34.         - Distribute Padlock on a BBS or through the internet. In fact,
  35.           I'd encourage you to distribute this software like there was
  36.           no tomorrow.
  37.         - Modify the source code for your own personal use.
  38.         - Use portions of Padlock's source code for writing other utilities,
  39.           as long as you don't distribute them without my prior permission
  40.           in writing.
  41.  
  42.   You may do the following only with my prior permission in writing:
  43.  
  44.         - Charge money for the use or distribution of Padlock.
  45.         - Distribute Padlock on CD-ROM or diskette as part of a compilation
  46.           of other shareware and freeware.
  47.         - Include Padlock in the distribution of some other product.
  48.         - Use any part of Padlock's source code in another piece of software
  49.           available publicly.
  50.  
  51.   You may not:
  52.  
  53.         - Take credit for writing Padlock or any portion thereof, no matter
  54.           how much you've modified its source code.
  55.         - Distribute modified versions of Padlock.
  56.         - Add or remove any files to the Padlock distribution archive. This
  57.           includes BBS adds.
  58.         - Remove the copyright notice or author's name from the program.
  59.         - Reproduce the source code in any form.
  60.        
  61.  
  62.         Please remember that this is copyrighted software. Although it is
  63.         free, it is NOT in the public domain. If you've written bug fixes
  64.         or patches for Padlock, please do not distribute them. Instead,
  65.         send them to me for inclusion in the next release, and if I decide
  66.         to include them, you will be credited for your work.
  67.  
  68.  
  69.  
  70.                              I n t r o d u c t i o n
  71.                              _______________________
  72.  
  73.         The document you are reading now was put together in a real rush.
  74. I'm hoping to include better documetation in a future release. If there's 
  75. any die-hard Padlock user out there who would be interested in writing a 
  76. better user's manual for me, I'd be very grateful. <grin>
  77.  
  78.         Padlock is a flexible call back verifier for Maximus 3.xx and up.
  79. It has been written entirely in Mex (The Maximus EXtension Language) to
  80. ensure portability and to enable you to customize it however you want. 
  81.  
  82.         Pleez exkuze my speling. I havint had a chanse to spel chek this
  83. fiel yet.
  84.  
  85.  
  86.                                 F e a t u r e s
  87.                                 _______________
  88.  
  89.         This section describes Padlock's features and describes its behaviour.
  90. If you just want to get started
  91.  
  92.         Padlock's features include:
  93.  
  94.         - Multinode friendly.
  95.         - International phone number support.
  96.         - Padlock can often guess a user's phone number if it is in the
  97.           wrong format.
  98.         - Sysop-definable logic for adding prefixes and suffixes to phone
  99.           numbers from particular areas. 
  100.         - Verifications to different areas can be restricted to particular 
  101.           times of the day.
  102.         - The user's city can be updated based on their phone number.
  103.         - Auto detection of long distance phone numbers.
  104.         - Baudrate checking.
  105.         - Many wildcards are supported for specifying phone numbers in the
  106.           input file.
  107.         - Additional verification attempts can be made if another user tries
  108.           to call the BBS during a verification.
  109.         - Runs under DOS, Win 95, OS/2 2.1, and OS/2 Warp.
  110.         - Most output is done through user-editable .MEC files.
  111.         - Complete Mex source code included.
  112.         - The user's security level can be automatically updated after
  113.           a successful verification. User keys can also be added or removed.
  114.         - Cursor animation and line editing for most user input.
  115.         - Very flexible. Every aspect of Padlock's behaviour is user
  116.           configurable. Padlock can even be set up to duplicate the behaviour
  117.           of most other popular verifiers.
  118.  
  119.  
  120.                      S y s t e m   R e q u i r e m e n t s
  121.                      _____________________________________
  122.  
  123.         In order to run Padlock, you must have the following:
  124.  
  125.         - Maximus CBCS v3.00 or higher. Padlock will NOT run with Maximus 
  126.           versions earlier than version 3, and it will not run with any 
  127.           other BBS package (sorry).
  128.         - An operating system capable of running Maximus 3.00. Padlock
  129.           should be able to run under any environment Maximus can.
  130.         - 500k of hard disk space.
  131.  
  132.         I have tested Padlock 3.00 using the default settings on a Pentium 90
  133.         with a USR Sportster 14.4k under DOS 6.22, OS/2 2.1, OS/2 Warp, and
  134.         Win 95. In addition, OS/2 2.1 and OS/2 Warp were tested with a 
  135.         Zoom 28.8k modem. 
  136.  
  137.  
  138.                            I n s t a l l a t i o n
  139.                            _______________________
  140.  
  141.  
  142. 1.      Move all the files into their own directory. By default, I use a 
  143.         directory inside my main Max directory called PADLOCK.
  144.  
  145. 2.      Back up all the default control files that come with Padlock
  146.         just in case you change something that doesn't work.
  147.  
  148. 3.      Edit SETTINGS.MH. Follow the instructions in that file for more
  149.         information. 
  150.  
  151.         You may want to further customize Padlock by editing the file
  152.         INSETUP.MH, which controls the behaviour of the input/output
  153.         routines.
  154.  
  155. 4.      If you are upgrading from version 1.5, you will be able to use
  156.         your old PHONE.CTL file. Just rename the default PHONE.CTL that
  157.         comes with Padlock and copy yours into the padlock directory.
  158.         Otherwise, edit the file PHONE.CTL to reflect your local calling
  159.         area. Follow the instructions in that file for more information.
  160.  
  161. 5.      Edit PADLOCK.MEC. The last five lines should look like:
  162.  
  163.         [MEX]padlock\init
  164.         [MEX]padlock\getphone
  165.         [MEX]padlock\checknum
  166.         [MEX]padlock\verify
  167.  
  168.         Change these lines to reflect the directory that the padlock
  169.         mex files are kept in. For example, if you're keeping padlock
  170.         in the directory c:\stuff, change these lines to read:
  171.  
  172.         [MEX]stuff\init
  173.         [MEX]stuff\getphone
  174.         [MEX]stuff\checknum
  175.         [MEX]stuff\verify
  176.  
  177.         If you are keeping Padlock in the default directory (a directory
  178.         called "padlock" inside your main Max directory), then you
  179.         won't need to modify PADLOCK.MEC.
  180.         
  181. 5.      Go into the padlock directory and type
  182.  
  183.         BUILD [maximus directory] [mex include directory]
  184.  
  185.         where [maximus directory] is the directory where the maximus
  186.         executables can be found and [mex include directory] is the
  187.         dire